home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
getpty.z
/
getpty
Wrap
Text File
|
1998-10-20
|
4KB
|
67 lines
GGGGEEEETTTTPPPPTTTTYYYY((((3333)))) GGGGEEEETTTTPPPPTTTTYYYY((((3333))))
NNNNAAAAMMMMEEEE
_getpty, mkpts - get a PTY or Pseudo-TTY
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssttttaaaatttt....hhhh>>>>
####iiiinnnncccclllluuuuddddeeee <<<<uuuunnnniiiissssttttdddd....hhhh>>>>
####iiiinnnncccclllluuuuddddeeee <<<<ffffccccnnnnttttllll....hhhh>>>>
cccchhhhaaaarrrr ****____ggggeeeettttppppttttyyyy((((iiiinnnntttt ****ffffiiiillllddddeeeessss,,,, iiiinnnntttt ooooffffllllaaaagggg,,,, mmmmooooddddeeee____tttt mmmmooooddddeeee,,,,
iiiinnnntttt nnnnooooffffoooorrrrkkkk))));;;;
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
This function finds and allocates a pair of devices making a pseudo-TTY,
described in _p_t_y(7M).
If ffffiiiilllleeeeddddeeeessss is not null, then the file descriptor for the master or
controlling side of the pty is stored through the pointer. If
successful, a pointer to an internal, static area containing the name of
the slave device node is returned. The file descriptor is opened with
the value ooooffffllllaaaagggg, constructed as described in _o_p_e_n(2).
The access bits of the slave device node are set to mmmmooooddddeeee. The owner of
the slave device is set to the real UID of the caller, and the GID is
reset.
If nnnnooooffffoooorrrrkkkk is 0 and the process does not have effective UID 0, then this
function may execute /usr/sbin/mmmmkkkkppppttttssss to change the owner and permissions
of the node for the slave device.
The slave device file in /_d_e_v will be created if it does not already
exist.
This function may also use the facilities described in _g_e_t_g_r_e_n_t(3C) to
set the group of the slave device node.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
chmod(2), chown(2), getgrent(3C), open(2), pty(7M), tty(1), tty(7)
DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
A returned value of 0 indicates failure, with _e_r_r_n_o indicating the nature
of the problem.
BBBBUUUUGGGGSSSS
When __g_e_t_p_t_y(3) uses /usr/sbin/mmmmkkkkppppttttssss, it waits for it to finish with
_w_a_i_t_p_i_d(2). This requires that the caller not have set SSSSIIIIGGGGCCCCLLLLDDDD to
SSSSIIIIGGGG____IIIIGGGGNNNN. Instead, __g_e_t_p_t_y(3) should save and restore the signal handler.
See wait(2) and signal(2). The nnnnooooffffoooorrrrkkkk argument can used to avoid
undesirable forks.
PPPPaaaaggggeeee 1111